home *** CD-ROM | disk | FTP | other *** search
/ FM Towns: Free Software Collection 6 / FM Towns Free Software Collection 6.iso / ms_dos / thf / thf.doc < prev    next >
Text File  |  1993-07-08  |  12KB  |  341 lines
  1.  
  2.  
  3.            “ＴＨｆ”テキスト・フォーマッタ　説明書き
  4.  
  5.  
  6.  
  7. 【配付ファイル】
  8.  
  9.     ＴＨｆは、以下のファイルで構成されています。
  10.  
  11.     THf.exe         プログラム本体
  12.     THf.c           ソース
  13.     THf.doc         ドキュメント
  14.     THf.thf         ドキュメントのソース
  15.  
  16.  
  17.  
  18. 【概略】
  19.  
  20.     　テキスト・フォーマッタを知らない人の為に説明します。一般に、パソコ
  21.     ン上での文章は、余程の都合が無いかぎり、ＤＯＳのテキスト形式を取りま
  22.     す。一番素直で、サポートしているソフトが最も多いと言えます。しかし、
  23.     これには多くの欠点があります。もともと、文字が適当に表示できればそれ
  24.     でいいというものなので、書式付けとかの指定が出来ませんし、それを手で
  25.     全て行ったら、後で書き直す時に困ります。例えば、以下の文章を書きたい
  26.     とします。
  27.  
  28.     ゴリラが煙草を吸っ
  29.     たことを、あなた
  30.     は見たことがあり
  31.     ますか？
  32.  
  33.     　もし、この「ゴリラ」というのを「オラウータン」にしたいとします。単
  34.     純に「ゴリラ」の文字を消し、「オラウータン」に置き換えただけでは、
  35.  
  36.     オラウータンが煙草を吸っ
  37.     たことを、あなた
  38.     は見たことがあり
  39.     ますか？
  40.  
  41.     　となります。もっと長い文章だと分かりやすいのですが、これをテキスト・
  42.     フォーマッタを使って書きますと、こう出来ます。
  43.  
  44.     オラウータンが煙
  45.     草を吸ったことを、
  46.     あなたは見たこと
  47.     がありますか？
  48.  
  49.     　このソフトには、重モードと単モードがあります。重モードとは、ピリオ
  50.     ド＋英小文字でコントロール・シーケンスとして書式を指示し、フォーマッ
  51.     ティングを行うことが出来ます。基本的に、このソフトはこれがメインです。
  52.     単モードとは、ただ単に禁足処理を行うだけです。
  53.     　言ってしまえば、重モードと単モードとの区別はしません。指定したファ
  54.     イルにコントロール・シーケンスが書かれていたらその処理をする、という
  55.     だけです。
  56.     　テキスト・フォーマッタには、色々なタイプがありますが、このソフトが
  57.     どれに属するか、作者自身は知りません。ただ、作表やマクロなどの機能は
  58.     やっぱりありませんし、単純な割には速度もあまり速く無いでしょう。
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66. 【起動方法】
  67.  
  68.     　コマンドラインから、実行します。その時に、入力ファイルを指定してく
  69.     ださい。拡張子は省略出来ませんが、.thfの時は省略できます。
  70.  
  71.         THf <input_file> [output-.ext]
  72.  
  73.     　入力ファイルの次には、出力ファイルの拡張子を決められます。拡張子だ
  74.     けを書いてください。なお、ピリオドは要りません（書かないで下さい）。
  75.     省略時にはＤＯＣになるので、そのままでも問題ないと思います。
  76.     　なお、何もコマンドラインに書かないと、ヘルプ画面を表示します。しか
  77.     し、あまり役には立たないでしょう。
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85. 【シーケンス一覧】
  86.  
  87.     　シーケンスは全て「ピリオド＋英小文字」ですので、英小文字の方だけを
  88.     抜き出します。便宜上、アルファベット順にはしていません。
  89.  
  90.     【入力操作系】
  91.  
  92.     d     書式を設定します。初期には、“％ｓ”と設定されています。Ｃ
  93.           と似たようなものを指定できますが、文字とその幅しか指定でき
  94.           ません。幅の指定方法ですが、パーセント記号とｓの間にそのま
  95.           ま数値を書くか、それとも不等号による括弧記号で挟まれたもの
  96.           をベース文字として使用します。なお、＆によるループ記号とい
  97.           うものがあり、この記号を指定すると、マクロが全て終わった時
  98.           に、最初に戻らずにこの直後にポイントされます。一つの書式の
  99.           かたまりを終える時は、文字列の最後にスラッシュ（割り算の記
  100.           号）を書いてください。そうすると、次は戻りません。なお、ルー
  101.           プ記号は最後に書くとエラーを通告します。
  102.  
  103.     dd    書式の有効非有効を切り換える。最初は有効。非有効時に書式を
  104.           変更しても、モードは持続する。
  105.  
  106.     di    マクロポインタをリセットします。ポインタは、ループ記号に係
  107.           わらず最初に戻ります。
  108.  
  109.     ns    空行があると、インデントを一つ浅くします。もし改行したい場
  110.           合は、改行系の命令を使用してください。
  111.  
  112.     n     空行を有効にします。デフォルトはこのモードです。空行がある
  113.           と、そのまま改行します。
  114.  
  115.     u     加工、非加工の変更をします。デフォルトは加工で、指定するた
  116.           びに非加工、加工となります。主に、このフォーマッタで処理出
  117.           来ないような表処理を行うとして、手作業でやるという時に使う
  118.           べきでしょう。
  119.  
  120.     to    タブを区切り文字として使えるようにします。この設定をしてお
  121.           きますと、タブが出てきたら、そこで文の終わりと判断します。
  122.  
  123.     tn    タブを通常文字として展開して扱います。と言っても、シーケン
  124.           ス行の時は区切り文字としての役割を果たします。
  125.  
  126.     ts    タブサイズを設定します。初期値は８です。
  127.  
  128.  
  129.     【加工要素設定系】
  130.  
  131.     w     全体幅を指定します。区切ったあとに、数値で指定します。上限
  132.           加減を間違えると、悲劇が起こるでしょう。デフォルトは、７２
  133.           です。この基準ですが、普通の文字は半角で７２文字分だけ書か
  134.           れ、最大で全角の括弧が一つはみ出し、そのあとに改行コードが
  135.           入ります。つまり、普通の８０桁エディタ、ページャーの場合は、
  136.           ７７がもっとも効率よく正常に見れます。下限は、実際の行出力
  137.           の時にエラーとして分かります。
  138.  
  139.     x     横のオフセットを決めます。インデント０の時の桁として設定し
  140.           ます。初期値は０です。
  141.  
  142.  
  143.     【加工出力系】
  144.  
  145.     aN    改行による項目を作り、インデントを一つ増やします。もしaと
  146.           だけ書くと、そのまま項目には改行以外の装飾がされないままに
  147.           出力されます。もしあとに０～９までの数値を書くと、記号が前
  148.           に出てきます。何が出るかは、試してみてください。aaと二つ並
  149.           べると、装飾無しのセンタリング項目を作ります。
  150.  
  151.     bN    aと同じですが、インデントが増えません。なお、無装飾のセン
  152.           タリングはbaとなります。
  153.  
  154.     t     タイトルを出します。と言っても、事実上は改行とセンタリング
  155.           の組合せです。このあとにタブかスペースをおき、そのあとに文
  156.           を書いてください。日付とか、余計な出力は一切しません。
  157.  
  158.     c     センタリングを行います。このあとに、タブかスペースを挟んで、
  159.           文を書いてください。もし、センタリングが出来ないほど長かっ
  160.           たら、エラーを通告します。
  161.  
  162.     s     項目の出力を行います。指定した文を、括弧で囲ったあとに出力
  163.           します。そのあとに、インデントが自動的に１つ増えます。
  164.  
  165.     m     インデントを初期化し、改行を五回行ったあとに項目を作ります。
  166.           あとはsと同じです。やはり、インデントは１つ増えます。何に
  167.           使うかと言うと、sはネストできるのに対し、mはできません。親
  168.           の項目を作る時に使えます。
  169.  
  170.     z     右寄せを行います。このあとに文を書いてください。
  171.  
  172.  
  173.     【インデント操作系】
  174.  
  175.     i     インデントを深くします。何も指定しないと、一つだけ深くなり
  176.           ます。このあとに、スペースかタブを置いて数値を指定すると、
  177.           その分だけインデントを深くします。注意することは、インデン
  178.           トする直接の空白を決める訳では無いことです。
  179.  
  180.     iw    一つのインデントの空白数を設定します。半角だけが有効です。
  181.  
  182.     ic    インデントの空白を、適当なものに変えます。半角文字しか指定
  183.           できません。文字列として指定しますが、有効なのは最後の文字
  184.           だけです。
  185.  
  186.     o     インデントを解除します。何も指定しないと、１つだけ解除し、
  187.           数値を書くと、その分だけ解除します。なお、インデントはマイ
  188.           ナスにはなりませんし、その警告も出しません。
  189.  
  190.     si    次の表示行から有効になる、サブインデントを設定します。特徴
  191.           としては、項目に対しては有効で無い事と、直接空白数で指定す
  192.           る事です。これは、文の一行目だけはインデントを浅くしたい時
  193.           に使います。この部分も、それを使って書かれています。
  194.  
  195.  
  196.     【改行系】
  197.  
  198.     r     改行します。数値を指定すれば、その分だけ改行し、何も指定し
  199.           なければ、１つだけします。
  200.  
  201.     f     上下の文の間隔を指定します。実際は、その分だけ改行するだけ
  202.           です。次の行に文があったときにのみ、実行します。
  203.  
  204.     　これらのコードは全て、行頭にある必要があります。つまり、設定は行単
  205.     位で行うしかありません（行の途中ではシーケンスを発行出来ない）。
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213. 【書式仕様】
  214.  
  215.     　Ｄコマンドで指定できる書式は、いくつかあります。
  216.  
  217.     【書式１】
  218.  
  219.     ％〔最大幅〕｛ｓ，ｃ｝
  220.  
  221.     　最大幅を指定すると、少なくとも半角にしてその分だけは書かれます。
  222.     読み取った文字列をはめてみて、オーバーしたらオーバーして表示し、
  223.     満たなかったらインデント文字で埋めます。ｓの時、幅はマイナスでも
  224.     指定でき、その時は左寄せになります。ｓで最大幅が正の数だったとき
  225.     は右寄せとなります。ｃの時はセンタリングを行います。
  226.  
  227.     【example】
  228.  
  229.         %-10s
  230.         %5c
  231.  
  232.  
  233.  
  234.     【書式２】
  235.  
  236.     ％＜〔ベース文字列〕＞〔＋／－〕{ｓ，ｃ}
  237.  
  238.     　ベース文字でまず埋め、その上から読み込んだ文字列を重ねます。オー
  239.     バーした時はベース文字列は幅のみを指定しただけになりますが、満た
  240.     なかった時はベース文字列が代わりに埋められます。符号とかは書式１
  241.     と変わりません。
  242.  
  243.     【example】
  244.  
  245.         %<-------->-s
  246.         %<***************>c
  247.  
  248.  
  249.  
  250.     【特殊指定子】
  251.  
  252.     　％に大文字のＣを書くと、現在のテキストフォーマットの幅に合わせ
  253.     て取り込んだ文字列のセンタリングを行います。Ｚを指定しますと、右
  254.     寄せになります。フォーマット処理でセンタリングを使いたい場合は、
  255.     これらを使ってください。
  256.  
  257.  
  258.     【ループ記号】
  259.  
  260.     　半角＆は、ループ記号として予約されています。
  261.     　＆で挟まれた部分は、書式をループさせます。普通に文字列を書式に
  262.     当てはめていくと無限に繰り返し続けるので、抜けたい時は文字列の最
  263.     後に半角／（スラッシュ）を書いてください。この処理の為、半角／は
  264.     最後には書けません。なお、一つしか＆が無かった時は、書式の最後ま
  265.     でのループとなります。
  266.  
  267.  
  268.     【ダミー文字列】
  269.  
  270.     　スラッシュ（割り算の記号）は、ヌル文字列として処理されます。つ
  271.     まり、ダミーという事になります。書式設定の時にダミーが必要になる
  272.     事がありますので、その時に使ってください。
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281. 【シーケンス一覧表】
  282.  
  283.     com.    op.     command name                    default 
  284.  
  285.     aN      <st>    paragraph A                             
  286.     bN      <st>    paragraph B(not indent)                 
  287.     c       <st>    Centering                               
  288.     d       [st]    Define format                     "%s"  
  289.     dd              Define on/off                      on   
  290.     di              Define init                             
  291.     f       <n>     Format return(cr+lf)               0    
  292.     i       [n]     indent In                          0    
  293.     ic      <st>    Indent Charactor                 space  
  294.     iw      <n>     Indent Width                       4    
  295.     m       <st>    Master paragraph                        
  296.     n               Null-line skip cancel            cancel 
  297.     ns              Null-line Skip                          
  298.     o       [n]     indent Out                         0    
  299.     r       [n]     Return(cr+lf)                           
  300.     s       <st>    Sub paragraph                           
  301.     si      <n>     Sub Indent                         0    
  302.     t       <st>    Title                                   
  303.     to              Tab on                             on   
  304.     tn              Tab not                                 
  305.     ts      <n>     Tab Size                           8    
  306.     u               Un-edit or not                          
  307.     w       <n>     Width                              72   
  308.     x       <n>     X offset                           0    
  309.     z       <st>    righting                                
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317. 【次回への課題】
  318.  
  319.     　ページを作ってしまおうという事も考えている。それに伴い、大項目（名
  320.     前）と小項目を上に書き、改ページとか項目設定などの命令が追加される。
  321.     印刷の段階では良いかもしれないが、普通にディスプレイで見るだけならば
  322.     あまり意味が無いので、見やすい文章というのをもう一度考えてから付け足
  323.     す。
  324.  
  325.  
  326. 【改変履歴】
  327.  
  328.     １９９２／１２／１１     Ｖ１.０   初版．
  329.     １９９２／１２／１２     Ｖ２.０   書式設定の追加．
  330.     １９９２／１２／２３     Ｖ２.１   タブの有効処理、右寄せ、書式の中
  331.                        のセンタリング、エラー処理、指定
  332.                        方法の変更．
  333.     １９９３／０１／０７     Ｖ２.２   インデントのタブによる最適化、書
  334.                        式中の右寄せ、書式中のテキスト幅
  335.                        によるセンタリング、設定ファイル
  336.                        を無くした、バグ修正など．
  337.     １９９３／０１／０９     Ｖ２.２ａ スラッシュ重複などのバグ修正．
  338.     １９９３／０１／１５     Ｖ２.３   ａｄを削除、ｎｓを拡張、＆ループ
  339.                        の拡張．
  340.     １９９３／０１／３０     Ｖ２.３ａ ＃の注釈、ｄｄの追加．
  341.